Resolve

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODNameResolver

Resolve
The Resolve method resolves an object specifier into a token that identifies the target object.
void Resolve (in ODObjectSpec theObject,
              in ODOSLToken token, 
              in ODPart contextPart);
theObject
A reference to the object specifier to be resolved.
token
A reference to the final token produced by the resolution.
contextPart
A reference to the part calling this method (that is, the context for the supplied token).

DISCUSSION
OpenDoc calls this method to resolve object specifiers in the direct parameter of an Apple event. In addition, your part should call this method to begin the resolution of an object specifier. Note that this method does not allow you to specify any callback flags. These flags are set by the semantic interface of each part using the semantic interface's SetOSLSupportFlags method. This method may call the object accessors of one or more parts to resolve the object specifier.
The contextPart parameter must be a reference to the part that calls this method.
Your part is responsible for deleting the returned token when it is no longer needed by calling the name resolver's DisposeToken method.

EXCEPTIONS

kODErrOutOfMemory
There is not enough memory to allocate the needed internal structures.
The Apple Event Manager may throw an exception if the specified part was invalid or the part does not support the semantic interface extension.
Parts and OpenDoc may throw other exceptions.

SEE ALSO
The ODNameResolver::CallObjectAccessor method (page 420).
The ODNameResolver::DisposeToken method (page 423).
The ODSemanticInterface::CallObjectAccessor method (page 595).
The ODSemanticInterface::SetOSLSupportFlags method (page 599).
Table 9-1 on page 408 in OpenDoc Programmer's Guide.
"Apple Event Object Model" on page 409 in OpenDoc Programmer's Guide.
"Writing Semantic-Event Handlers" on page 423 in OpenDoc Programmer's Guide.
"Writing Object Accessors" on page 425 in OpenDoc Programmer's Guide.
"Object Resolution" on page 425 in OpenDoc Programmer's Guide.
The "Resolving and Creating Object Specifier Records" chapter of Inside Macintosh: Interapplication Communication.